home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 1999 May / SGI IRIX Installation Tools & Overlays 1999 May - Disc 2.iso / relnotes / dmedia_eoe / ch15.z / ch15
Text File  |  1999-04-19  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        15.  _D_i_g_i_t_a_l__M_e_d_i_a__D_S_O_'_s
  9.  
  10.  
  11.        A number of shared execution libraries (DSO's) are included
  12.        in the _d_m_e_d_i_a__e_o_e images. The directory /usr/lib contains
  13.        versions of these DSO's for use by o32 applications, and the
  14.        directory /usr/lib32 contains versions for use by n32
  15.        applications. The subsystems _d_m_e_d_i_a__e_o_e._s_w._l_i_b and
  16.        _d_m_e_d_i_a__e_o_e._s_w_3_2._l_i_b install the o32 and n32 versions of the
  17.        base DSO's respectively. The subsystems
  18.        _d_m_e_d_i_a__e_o_e._s_w._p_l_u_g_i_n_s and _d_m_e_d_i_a__e_o_e._s_w_3_2._p_l_u_g_i_n_s install
  19.        the o32 and n32 versions of special-effects plug-in modules.
  20.  
  21.        This section briefly describes the functions of the
  22.        different digital media DSO's.
  23.  
  24.  
  25.        15.1  _A_u_d_i_o__L_i_b_r_a_r_y
  26.  
  27.        The Audio Library provides an application software interface
  28.        to the audio I/O device capabilities of the system.
  29.  
  30.  
  31.        15.1.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  32.  
  33.           +o In IRIX 6.4, and starting with IRIX 6.3, the Audio
  34.             Library is now a DSO rather than a static library. It
  35.             is installed as /usr/{lib,lib32,lib64}/libaudio.so.1.
  36.             Applications which were linked with libaudio.a in
  37.             previous releases will continue to operate properly in
  38.             IRIX 6.4.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.        15.2  _V_i_d_e_o__L_i_b_r_a_r_y
  45.  
  46.        The Video Library provides an application software interface
  47.        to the video I/O device capabilities of the system, as well
  48.        as access to special video hardware paths such as video to
  49.        screen or screen capture to memory on some systems which
  50.        have these features. The Video Library DSO is installed as
  51.        /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_v_l._s_o.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        15.3  _D_i_g_i_t_a_l__M_e_d_i_a__L_i_b_r_a_r_y__a_n_d__I_m_a_g_e_/_A_u_d_i_o__C_o_n_v_e_r_t_e_r_s
  75.  
  76.        The Digital Media Library provides core functionality for
  77.        digital media applications. Functionality in IRIX 6.4
  78.        includes:
  79.  
  80.           +o IIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt: a software framework for
  81.             managing software image codecs and realtime memory-to-
  82.             memory image codecs which rely on hardware
  83.             acceleration.
  84.  
  85.           +o AAAAuuuuddddiiiioooo ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt: a software framework for
  86.             managing audio data conversion including
  87.             compression/decompression, sampling rate conversion,
  88.             sample data format conversion, and channel matrix
  89.             conversion.
  90.  
  91.           +o DDDDiiiiggggiiiittttaaaallll mmmmeeeeddddiiiiaaaa bbbbuuuuffffffffeeeerrrr ssssyyyysssstttteeeemmmm: a software framework which
  92.             allows memory buffers containing compressed or
  93.             uncompressed image data to be moved with copying
  94.             between various subsystems including video I/O ports,
  95.             software or realtime memory-to-memory image
  96.             compressors, and OpenGL.
  97.  
  98.           +o SSSSooooffffttttwwwwaaaarrrreeee ccccoooolllloooorrrr ssssppppaaaacccceeee ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn: the Digital Media
  99.             Library includes optimized code for performing high
  100.             quality color space conversion in software.
  101.  
  102.           +o DDDDiiiiggggiiiittttaaaallll mmmmeeeeddddiiiiaaaa nnnneeeettttwwwwoooorrrrkkkkiiiinnnngggg: a network-independent
  103.             framework which allows the interchange of _D_M_b_u_f_f_e_r_s
  104.             between processes, whether on the same machine or on
  105.             machines connected by a network.
  106.  
  107.  
  108.        15.3.1  _D_i_g_i_t_a_l__M_e_d_i_a__L_i_b_r_a_r_y__D_S_O_'_s  The Digital Media
  109.        Library is composed of the following DSO's:
  110.  
  111.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_d_m_e_d_i_a._s_o: The Digital Media
  112.             Library.
  113.  
  114.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_i_m_a_g_e_c_o_n_v_e_r_t_e_r_s/*._s_o: Image
  115.             converter modules for software image codecs and
  116.             realtime memory-to-memory hardware-accelerated codecs.
  117.             These modules are loaded at runtime by the Digital
  118.             Media Library when required by an application. They are
  119.             not loaded directly by applications.
  120.  
  121.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_a_u_d_i_o_c_o_n_v_e_r_t_e_r_s/*._s_o: Audio
  122.             converter modules for audio compression/decompression,
  123.             audio sampling rate conversion, and audio data format
  124.             and channel matrix conversion. These modules are loaded
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             at runtime by the Digital Media Library when required
  141.             by an application. They are not loaded directly by
  142.             applications.
  143.  
  144.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_c_l._s_o: The "old" Compression
  145.             Library. This library provides the developer interface
  146.             and software framework for several image codecs and a
  147.             few audio codecs in IRIX 6.2 and earlier releases. The
  148.             full IRIX 6.2 functionality is supported in IRIX 6.4
  149.             and future releases for backward compatibility with
  150.             existing applications. Low level image codec modules in
  151.             the "imageconverters" directory are now shared by
  152.             libdmedia.so and libcl.so.
  153.  
  154.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_a_w_a_r_e_a_u_d_i_o._s_o: Aware,Inc audio
  155.             compression framework DSO. There are no routines in
  156.             this DSO that are visible to developers. This DSO is
  157.             used internally by libcl.so for interfacing to the MPEG
  158.             and Aware, Inc MultiRate codecs only.
  159.  
  160.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_a_u_d_i_o_u_t_i_l._s_o: In earlier releases,
  161.             this library included audio conversion and compression
  162.             operations. In IRIX 6.3 and IRIX 6.4, audio conversion
  163.             operations have all been centralized in the Digital
  164.             Media Library, libdmedia.so. As a result,
  165.             libaudioutil.so is now a symlink to libdmedia.so.
  166.  
  167.           +o /usr/{lib,lib32}/libdmnet.so: _T_h_i_s _l_i_b_r_a_r_y _p_r_o_v_i_d_e_s _a
  168.             _s_t_a_n_d_a_r_d _A_P_I _f_o_r _m_o_v_i_n_g _D_i_g_i_t_a_l _M_e_d_i_a _b_u_f_f_e_r_s _b_e_t_w_e_e_n
  169.             _a_p_p_l_i_c_a_t_i_o_n_s _o_n _t_h_e _s_a_m_e _m_a_c_h_i_n_e _o_r _a_p_p_l_i_c_a_t_i_o_n_s
  170.             _s_e_p_a_r_a_t_e_d _b_y _a _n_e_t_w_o_r_k.
  171.  
  172.  
  173.        _1_5._3._2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  174.  
  175.           +o The DMNet API for Digital Media Networking is an
  176.             addition to IRIX 6.5.  It provides a standard API on
  177.             all IRIX platforms for interchanging Digital Media
  178.             buffers between processes, whether they are on the same
  179.             machine or separated by a network.
  180.  
  181.  
  182.  
  183.  
  184.        15.4  _M_o_v_i_e__L_i_b_r_a_r_y
  185.  
  186.        The Movie Library provides core library software for
  187.        reading, writing, editing, and playing back standard movie
  188.        file formats (QuickTime, AVI, MPEG-1 video/systems
  189.        bitstreams, SGI Movie).
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        Starting with IRIX 6.3, the Movie Library is now composed of
  207.        a set of DSO's rather than a single static library.
  208.        Applications which were linked with libmovie.a in previous
  209.        releases will continue to operate properly in IRIX 6.4.
  210.  
  211.  
  212.        15.4.1  _M_o_v_i_e__L_i_b_r_a_r_y__D_S_O_'_s  The Movie Library is composed
  213.        of the following DSO's:
  214.  
  215.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_m_o_v_i_e_f_i_l_e._s_o: The Movie File
  216.             Library. This DSO implements file read, write, edit
  217.             support. It is a high-level library which builds on top
  218.             of the image compression/conversion and audio
  219.             compression/conversion functions in the core Digital
  220.             Media Library.
  221.  
  222.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_m_o_v_i_e_p_l_a_y._s_o: The Movie Playback
  223.             Library. This DSO provides high level playback and
  224.             transport control functions to applications.  It is
  225.             built on top of the "lower level" functions provided by
  226.             the Movie File Library, and uses OpenGL and the Audio
  227.             Library for rendering synchronized audio/image output.
  228.  
  229.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_m_o_v_i_e/*._s_o: Movie display ports
  230.             and rendering modules loaded internally by the playback
  231.             engine, libmovieplay.so, as required at runtime.
  232.             Applications do not load these modules directly.
  233.  
  234.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/{_l_i_b_m_o_v_i_e._s_o,_l_i_b_m_o_v_i_e_G_L._s_o}: These
  235.             are now "stub" DSO's which simply make available all
  236.             the public symbols from libmovieplay.so and
  237.             libmoviefile.so.  They exist only to provide backward
  238.             compatibility with link lines for applications that
  239.             were previously built using "-lmovie" or "-lmovieGL".
  240.             In IRIX 6.4, it is strongly recommended that developers
  241.             explicitly link with "-lmovieplay -lmoviefile" or just
  242.             "-lmoviefile" as appropriate.
  243.  
  244.  
  245.        15.4.2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  246.  
  247.           +o The Movie Library is no longer statically linked into
  248.             applications. It is now composed of two high-level
  249.             DSO's, libmoviefile.so and libmovieplay.so, which
  250.             contain the public movie file and playback API's, as
  251.             well as several of rendering and playback modules
  252.             loaded internally by libmovieplay.so.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        15.4.3  _B_u_g__F_i_x_e_s
  273.             Bug 610006: An internal Movie Library data structure
  274.             and the algorithm that managed its growth could
  275.             fragment the application memory heap and cause poor
  276.             performance during movie capture. The data structure
  277.             and algorithm have been corrected in Irix 6.5.1m.
  278.  
  279.           +o
  280.  
  281.  
  282.  
  283.        15.5  _A_u_d_i_o__F_i_l_e__L_i_b_r_a_r_y
  284.  
  285.        The Audio File Library, /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_a_u_d_i_o_f_i_l_e._s_o,
  286.        provides core library software for reading and writing a
  287.        variety of sound file formats (see the "Supported Media File
  288.        Formats" chapter of these release notes).
  289.  
  290.        The Audio File Library is a high-level library that makes
  291.        use of the lower-level audio compression and conversion
  292.        functions offered by the core Digital Media Library.
  293.  
  294.  
  295.        15.5.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  296.  
  297.           +o Addition of support for 32- and 64-bit floating point
  298.             AIFF-C files.
  299.  
  300.           +o Addition of support for AIFF-C files which use IMA4:1
  301.             compression, and full compliance with Apple, Inc.
  302.             AIFF-C compression specifications.
  303.  
  304.  
  305.  
  306.  
  307.        15.6  _M_I_D_I__L_i_b_r_a_r_y
  308.  
  309.  
  310.        The MIDI Library, /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_m_d._s_o, provides an
  311.        application interface to the IRIX MIDI I/O system built.
  312.        This system offers support for timestamped MIDI I/O through
  313.        serial ports, and for delivery of interprocess MIDI events
  314.        (eg, play back a MIDI sound file using _I_S_o_u_n_d_P_l_a_y_e_r(_1) and
  315.        trigger music synthesis on a second process, the software
  316.        MIDI synthesizer).
  317.  
  318.  
  319.        15.6.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  320.  
  321.           +o The MIDI Library has not changed since IRIX 6.2.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        15.6.2  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  339.  
  340.           +o In IRIX 6.4, MIDI I/O through the serial ports is fully
  341.             functional for the Onyx2 workstation and also for
  342.             Origin2000 with the optional base audio option.  In
  343.             IRIX 6.3, MIDI I/O through the serial ports is not
  344.             functional on the O2 workstation.  It is our hope that
  345.             we will be able to provide this functionality for IRIX
  346.             6.3 in the form of a patch.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.